home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / system / uznix120.zip / UZFULNIX.TXT < prev    next >
Text File  |  1994-10-18  |  11KB  |  355 lines
  1.  
  2. OVERVIEW
  3. --------
  4.     UZfulnix is a subset of useful Unix(TM) utilities for PCs
  5. running MS-DOS 3.x and later. This toolset is really intended for the
  6. hard-core Unix user, although certain programs are worth looking into by
  7. the DOS- oriented, specially if they do not modify files (eg. df, du,
  8. more, tail, which). The toolset is designed to complement the GNUish
  9. MS-DOS tools (although there is some overlap). The current release
  10. contains the following utilities: basename, cal, cat, cmp, date, dd, df,
  11. du, find, more, mv, od, pwd, rm, sleep, strings, sum, tail, tee, time,
  12. touch, uudecode, uuencode, wc, which.
  13.  
  14.  
  15. INSTALLATION
  16. ------------
  17.     The simplest alternative to install UZfulnix is to follow these
  18. instructions:
  19.  
  20. 1) Make a separate directory (using mkdir from the DOS prompt) and copy
  21.    the files from your distribution medium (either extract it from a
  22.    downloaded archive file (PKZIP, LHARC, ZOO, ...), or copy from the
  23.    diskette) into that directory.  It is highly recommended to install
  24.    into a newly created directory, so that you can easily upgrade or
  25.    uninstall later.
  26.  
  27. 2) Edit the file C:\AUTOEXEC.BAT to add the directory which contains
  28.    the UZfulnix executables to the PATH variable. The order of the
  29.    directories in the PATH variable matters, and we recommend to put
  30.    the UZfulnix directory at the beginning of the list (specially
  31.    before the DOS directory!).
  32.  
  33. 3) Reboot the computer. You are ready to use the UZfulnix utilities.
  34.  
  35.     To uninstall UZBlank in the event you are not going to use it,
  36. simply reverse the steps above, that is:
  37.  
  38. 1) Remove the directory from the PATH variable.
  39.  
  40. 2) Remove the executables.
  41.  
  42.  
  43. USAGE
  44. -----
  45.     The utilities are designed to emulate the original Unix
  46. functionality (in particular, the SunOS 4.1.3 variant) as closely as
  47. possible. For this reason, if you have access to the Unix manual pages,
  48. they will provide the most complete documentation. Alternatively, any
  49. book on Unix utilities will show you sample usage of most of them. Since
  50. they are well documented in other places, we present here only a brief
  51. description of each program:
  52.  
  53. basename - print base file name of a pathname
  54.  
  55.     This command is often used in shell scripts. For example:
  56.  
  57.     $ for file in rcs/*.*
  58.     do
  59.         rcs -nversion1: `basename $file`
  60.     done
  61.  
  62.     NOTE: this command by itself does not modify any files.
  63.  
  64.     DOS equivalents: NONE
  65.  
  66.  
  67. cal - print calendar
  68.  
  69.     NOTE: this command by itself does not modify any files.
  70.  
  71.     DOS equivalents: NONE
  72.  
  73.  
  74. cat - concatenate files
  75.     No command line options implemented.
  76.  
  77.     Can be used to concatenate two or more files, such as
  78.     C:\> cat a b c > d
  79.  
  80.     NOTE: this command only modifies files if you redirect the output
  81.     (eg. with the > construct).
  82.  
  83.     DOS equivalents: type
  84.  
  85. cmp - binary compare 2 files
  86.  
  87.     NOTE: this command by itself does not modify any files.
  88.  
  89.     DOS equivalents: fc /b
  90.  
  91. date - print current date and time
  92.  
  93.     Supports most of the System V output formats. Does not set time
  94.     (yet).
  95.  
  96.     NOTE: Since COMMAND.COM also has a built-in 'date' command, you
  97.     have to rename or copy this command to something like 'udate'.
  98.  
  99.     NOTE: this command does not modify any files.
  100.  
  101.     DOS equivalents: date, time
  102.  
  103. dd - copy data in a variety of formats and sizes
  104.  
  105.     All the useful options are implemented:
  106.  
  107.     if=name  Input file name.  The standard input is the default.
  108.     of=name  Output file name.  The standard output is the default.
  109.     ibs=n    Input block size, n bytes. The default is 512 bytes.
  110.     obs=n    Output block size, n bytes. The default is 512 bytes.
  111.     bs=n     Set both input and output block size to n bytes.
  112.     skip=n   Skip n input records before starting to copy.
  113.     seek=n   Seek n records from beginning of output file before copying.
  114.     count=n  Copy only n input records.
  115.  
  116.     This command is most useful to split a large file into multiple
  117.     smaller pieces, eg.
  118.  
  119.     C:\> dd if=foo of=a:bar bs=50k count=28
  120.  
  121.     will copy the first 1.4MB of the file foo to the file bar on
  122.     floppy drive a:.
  123.  
  124.     NOTE: this command DOES modify files, so be careful.
  125.  
  126.     DOS equivalents: NONE
  127.  
  128. df - display free disk drive space
  129.  
  130.     Displays used and available disk space of disk partitions.
  131.     By default, displays information for the hard-disk partitions.
  132.     With arguments, you can get information for floppies.
  133.  
  134.     C:\> df
  135.     Drive    Total    Used    Available
  136.         kbytes    kbytes    kbytes
  137.     --------------------------------
  138.     C:     204436     183668      20768
  139.  
  140.     C:\> df a:
  141.     Drive    Total    Used    Available
  142.         kbytes    kbytes    kbytes
  143.     --------------------------------
  144.     A:       1423        323       1100
  145.  
  146.     NOTE: this command by itself does not modify any files.
  147.  
  148.     DOS equivalents: dir (incomplete)
  149.  
  150. du - print disk usage of files and directories
  151.  
  152.     This command displays disk space used by files and directories.
  153.     For a directory, it displays the space used by all the files
  154.     underneath. This command is most useful with the -s switch, to
  155.     determine whether you can fit a subdirectory onto a floppy
  156.     without compression.
  157.  
  158.     NOTE: this command by itself does not modify any files.
  159.  
  160.     DOS equivalents: NONE
  161.  
  162. find - find files
  163.  
  164.     Finds files that match certain criteria, then either displays
  165.     them or executes a command on them. All useful options are
  166.     implemented:
  167.  
  168.     -name expr       match files by name
  169.     -type file-type  match files by type
  170.     -mtime time-expr match files by modification time
  171.     -print           print matching files
  172.     -exec expr       execute a command for each matching file
  173.  
  174.     Here are some examples:
  175.  
  176.     C:\> find . -name a*.exe -print
  177.  
  178.     displays all executable files that start with 'a' in all
  179.     directories on the C: drive, while
  180.  
  181.     C:\> find windows -name *.ini -exec grep load NUL {} \;
  182.  
  183.     executes the 'grep' command to find the string 'foo' in all
  184.     Windows INI files (the NUL argument makes grep display the
  185.     filename for any matching strings as well).
  186.  
  187.     NOTE: this command does not modify any files except possibly
  188.     with the -exec option.
  189.  
  190.     DOS equivalents: NONE
  191.  
  192. more - page a file
  193.  
  194.     This version of 'more' blows away the MS-DOS excuse of a file
  195.     pager.  Most of the features of the SunOS 'more' have been
  196.     implemented, including backward scroll with 'b', string search
  197.     with '/', editor invocation with 'v', skip file with ':n', etc.
  198.     '?' will give you the help message.
  199.  
  200.     NOTE: this command by itself does not modify any files.
  201.  
  202.     DOS equivalents: more
  203.  
  204. mv - move one or more files
  205.  
  206.     Moves files, even between disk partitions. Does not move
  207.     directories (yet).
  208.  
  209.     NOTE: this command DOES modify files.
  210.  
  211.     DOS equivalents: ren
  212.  
  213. od - octal dump
  214.  
  215.     Only the -x option is implemented.
  216.  
  217.     NOTE: this command by itself does not modify any files.
  218.  
  219.     DOS equivalents: debug
  220.  
  221. pwd - present working directory
  222.  
  223.     NOTE: this command by itself does not modify any files.
  224.  
  225.     DOS equivalents: NONE
  226.  
  227. rm - remove one or more files
  228.  
  229.     The -r, -f and -i options have been implemented.
  230.  
  231.     NOTE: this command is the most dangerous of the entire toolset,
  232.     thus has been disabled. You will have to explicitely rename the
  233.     file from RM.DIS to RM.EXE to enable this command. We recommend
  234.     using it only if you fully know its behaviour. See also the
  235.     'LIMITATIONS' section below.
  236.  
  237.     DOS equivalents: del, deltree
  238.  
  239. sleep - sleep for a specified period of time
  240.  
  241.     This command is most often used in scripts, if you want to
  242.     wait for a certain amount of time.
  243.  
  244.     NOTE: this command by itself does not modify any files.
  245.  
  246.     DOS equivalents: NONE
  247.  
  248. strings - find printable strings in one or more files
  249.  
  250.     NOTE: this command by itself does not modify any files.
  251.  
  252.     DOS equivalents: NONE
  253.  
  254. sum - checksum one or more files
  255.  
  256.     NOTE: this command by itself does not modify any files.
  257.  
  258.     DOS equivalents: NONE
  259.  
  260. tail - view the end of a file
  261.  
  262.     The -f option is implemented.
  263.  
  264.     NOTE: this command by itself does not modify any files.
  265.  
  266.     DOS equivalents: NONE
  267.  
  268. tee - output to a file and stdout
  269.  
  270.     NOTE: this command DOES modify files.
  271.  
  272.     DOS equivalents: NONE
  273.  
  274. time - give execution time of a command
  275.  
  276.     NOTE: this command by itself does not modify any files.
  277.  
  278.     DOS equivalents: NONE
  279.  
  280. touch - touch one or more files
  281.  
  282.     This command is used to update file modification timestamps.
  283.  
  284.     NOTE: this command by itself does not modify any file contents.
  285.  
  286.     DOS equivalents: NONE
  287.  
  288. uuencode/uudecode - encode/decode a uuencoded file
  289.  
  290.     The uuencode/uudecode utilities are used to encode binary data
  291.     for transmission over 7-bit channels, such as most of the
  292.     currently deployed e-mail protocols. The utilities in this
  293.     toolset are compatible with the Unix counterparts, although
  294.     there will be warning messages displayed (which you can ignore).
  295.  
  296.     To encode a binary file (eg. FILE.BIN), just say
  297.  
  298.     C:\ uuencode FILE.BIN FILE.BIN
  299.  
  300.     and it creates a file called FILE.UUE, which contains the
  301.     encoded contents of FILE.BIN. The file FILE.UUE can be
  302.     included in e-mail messages, and decoded by the recipient.
  303.  
  304.     To decode a uuencoded file, just say
  305.  
  306.     C:\ uudecode FILE.UUE
  307.  
  308.     and the original file is extracted. The filename of the original
  309.     file is contained in the "begin" line at the beginning of the
  310.     uuencoded file.
  311.  
  312. wc - count words and lines in one or more files
  313.  
  314.     NOTE: this command by itself does not modify any files.
  315.  
  316.     DOS equivalents: NONE
  317.  
  318. which - print path for an executable
  319.  
  320.     NOTE: this command by itself does not modify any files.
  321.  
  322.     DOS equivalents: NONE
  323.  
  324.  
  325. LIMITATIONS
  326. -----------
  327.     Due to "features" of the DOS environment, the programs have the
  328. following limitations:
  329.  
  330. - only DOS filename wildcards are supported. Be specially careful with
  331. the 'rm' command, since *a.* does not expand in DOS to what you think
  332. it should! This will be fixed in a future release.
  333.  
  334. - these tools override the default MS-DOS error handler to work correctly
  335. in a MS-DOS window under MS-Windows, ie. they will not go into full-screen
  336. mode on I/O error.
  337.  
  338. SUPPORT
  339. -------
  340.     If you are a registered user, UZful Software provides on-line
  341. support via e-mail at  uzful@mv.mv.com . When you report a problem,
  342. please include
  343. - the version of the UZfulnix utility, 
  344. - the type of PC you have, and
  345. - the symptoms of the problem (any special circumstances that make
  346.   the problem appear? Can you repeat the problem?). The more info
  347.   you provide, the quicker we can fix the problem.
  348.  
  349. If you have additional suggestions on how to make the product even more
  350. useful, please drop us a line.
  351.  
  352. UZful Software
  353. "We make the useful simple."
  354.  
  355.